![]() ![]() ![]() |
Start of Tutorial > Start of Trail > Start of Lesson | Search |
Mouse events tell you when the user uses the mouse (or similar input device) to interact with a component. Mouse events occur when the cursor enters or exits a component's on-screen area and when the user presses or releases the mouse button. Because tracking the cursor's motion involves significantly more system overhead than tracking other mouse events, mouse-motion events are separated into a separate listener type (see How to Write a Mouse Motion Listener). If your program needs to detect both mouse events and mouse-motion events, you can use Swing's convenientMouseInputAdapter
class, which implements bothMouseListener
andMouseMotionListener
.The following applet contains a mouse listener. At the top of the applet is a blank area (implemented, strangely enough, by a class named
BlankArea
). The mouse listener listens for events both on theBlankArea
and on its container, which is an instance ofMouseEventDemo
. Each time a mouse event occurs, a descriptive message is displayed under the blank area. By moving the cursor on top of the blank area and occasionally pressing mouse buttons, you can fire mouse events.
This is a picture of the applet's GUI. To run the applet, click the picture. The applet will appear in a new browser window.
You can find the applet's code in
Try this:
- Move the cursor into the yellow rectangle at the top of the applet.
You'll see one or more mouse-entered events.- Press and hold the mouse button.
You'll see a mouse-pressed event. You might see some extra mouse events, such as mouse-exited and then mouse-entered.- Release the mouse button.
You'll see a mouse-released event. If you didn't move the mouse, a mouse-clicked event will follow.- Press and hold the mouse button, and then drag the mouse so that the cursor ends up outside the applet's area. Release the mouse button.
You'll see a mouse-pressed event, followed by a mouse-exited event, followed by a mouse-released event. You are not notified of the cursor's motion. To get mouse-motion events, you need to implement a mouse-motion listener.MouseEventDemo.java
and
BlankArea.java
. Here is the applet's mouse event handling code:
public class MouseEventDemo ... implements MouseListener { ...//where initialization occurs: //Register for mouse events on blankArea and applet (panel). blankArea.addMouseListener(this); addMouseListener(this); ... public void mousePressed(MouseEvent e) { saySomething("Mouse pressed; # of clicks: " + e.getClickCount(), e); } public void mouseReleased(MouseEvent e) { saySomething("Mouse released; # of clicks: " + e.getClickCount(), e); } public void mouseEntered(MouseEvent e) { saySomething("Mouse entered", e); } public void mouseExited(MouseEvent e) { saySomething("Mouse exited", e); } public void mouseClicked(MouseEvent e) { saySomething("Mouse clicked (# of clicks: " + e.getClickCount() + ")", e); } void saySomething(String eventDescription, MouseEvent e) { textArea.append(eventDescription + " detected on " + e.getComponent().getClass().getName() + "." + newline); } }
TheMouseListener
interface and its corresponding adapter class,
MouseAdapter
, contain these methods:
void mouseClicked(MouseEvent)
- Called just after the user clicks the listened-to component.
void mouseEntered(MouseEvent)
- Called just after the cursor enters the bounds of the listened-to component.
void mouseExited(MouseEvent)
- Called just after the cursor exits the bounds of the listened-to component.
void mousePressed(MouseEvent)
- Called just after the user presses a mouse button while the cursor is over the listened-to component.
void mouseReleased(MouseEvent)
- Called just after the user releases a mouse button after a mouse press over the listened-to component.
One complication affects mouse-entered, mouse-exited, and mouse-released events. When the user drags (presses and holds the mouse button and then moves the mouse), then the component that the cursor was over when the drag started is the one that receives all subsequent mouse and mouse-motion events up to and including the mouse button release. That means that no other component will receive a single mouse event -- not even a mouse-released event -- while the drag is occurring.
Each mouse event method has a single parameter: a
MouseEvent
object. The
MouseEvent
class defines the following useful methods:
int getClickCount()
- Returns the number of quick, consecutive clicks the user has made (including this event). For example, returns 2 for a double click.
int getX()
int getY()
Point getPoint()
- Return the (x,y) position at which the event occurred, relative to the component that fired the event.
boolean isPopupTrigger()
- Returns
true
if the mouse event should cause a popup menu to appear. Because popup triggers are platform dependent, if your program uses popup menus, you should callisPopupTrigger
for all mouse-pressed and mouse-released events fired by components over which the popup can appear. See Bringing Up a Popup Menu for more information about popup menus.The
MouseEvent
class inherits the following handy method fromComponentEvent
.
Component getComponent
- Returns the component that fired the event. You can use this method instead of the
getSource
method.The
MouseEvent
class inherits many useful methods fromInputEvent
:
int getWhen()
- Returns the timestamp of when this event occurred. The higher the timestamp, the more recently the event occurred.
boolean isAltDown()
boolean isControlDown()
boolean isMetaDown()
boolean isShiftDown()
- Returns the state of individual modifier keys at the time the event was fired.
int getModifiers()
- Returns the state of all the modifier keys and mouse buttons when the event was fired. You can use this method to determine which mouse button was pressed (or newly released) when a mouse event was fired. The
InputEvent
class defines these constants for use with thegetModifiers
method:ALT_MASK
,BUTTON1_MASK
,BUTTON2__MASK
,BUTTON3_MASK
,CTRL_MASK
,META_MASK
, andSHIFT_MASK
. For example, the following expression is true if the right button was pressed:The(mouseEvent.getModifiers() & InputEvent.BUTTON3_MASK) == InputEvent.BUTTON3_MASKSwingUtilities
class contains convenience methods for determining whether a particular mouse button has been pressed:
static boolean isLeftMouseButton(MouseEvent)
static boolean isMiddleMouseButton(MouseEvent)
static boolean isRightMouseButton(MouseEvent)
The following table lists the examples that use mouse listeners.
Example Where Described Notes MouseEventDemo
This section Reports all mouse events that occur within a blank panel to demonstrate the circumstances under which mouse events are fired. CoordinatesDemo
Overview of Custom Painting An applet that draws a small circle where the user clicks the mouse. The applet also reports the x, y location of the mouse click. SelectionDemo
Overview of Custom Painting An applet that lets the user drag a rectangle to select a portion of an image. Uses a subclass of MouseInputAdapter
to listen to both mouse events and mouse-motion events.GlassPaneDemo
How to Use Root Panes Uses a subclass of MouseInputAdapter
to listen to mouse events and mouse-motion events on the root pane's glass pane. Redispatches the events to underlying components.TableSorter
How to Use Tables Listens to mouse events on a table header. Sorts data in the selected column. MovingLabels
Moving an Image Across the Screen Stops and starts an animation in response to mouse clicks. PopupMenuDemo
How to Use Menus Displays a popup menu in response to mouse clicks. ListDemo
How to Use Lists Listens for double mouse clicks on a list. Double clicks act as an accelerator for selecting an item in the list and pressing a button.
![]() ![]() ![]() |
Start of Tutorial > Start of Trail > Start of Lesson | Search |